CREATE-AUTHINFO1 Request

Function

This request is used to store an AuthInfo for a domain.

Maximum validity of an AuthInfo is 30 days. Upon expiration of this period (AuthInfoExpire) the AuthInfo will be deleted automatically.

Requirements

  • Only one AuthInfo1 can be stored for each domain.
  • The AuthInfo1 has to be between 8 and 16 characters long.
  • You can store an AuthInfo1 in addition to an existing AuthInfo2.
  • Only the administering RegAcc is entitled to store an AuthInfo1.
  • If an AuthInfo is stored for a "failed" domain, the EXPIRE date of the domain is communicated in the AuthInfo notification by e-mail.
  • You must create the hash by means of the SHA-256 algorithm. No Salt and just one iteration are allowed.
  • The output of the hash function (256 bit) must be encrypted hexadecimally in the request.

Request Parameters

A CREATE-AUTHINFO1 request is composed of the "Chprov" data object fields and some other parameters, which are described below:

K/V Keyword XML Namespace and Element Occurrence
min - max		 Type / Length Value Range Description
Action domain:createAuthInfo1 1 enumeration creauthinfo1-erule This is the request type.
Version - 1 enumeration version-erule This is the version. The keyword is only relevant for requests in the key/value format.
CtId ctid 0 - 1 token
3 - 64		 Any visible Unicode character (according to Unicode version 3.1) This is the unique transaction ID which is issued by the client.

Common Mistakes

  • The stated domain is not administered by the RegAcc submitting the request.
  • Encryption of the AuthInfo hash is invalid (not SHA256).
  • An AuthInfo1 already exists for the domain.

Features

An existing AuthInfo2 will persist.

 

Examples

Copy

request:CREATE-AUTHINFO1
format:kv

Version: 5.0
Action: create-authinfo1
Ctid: cba-987654321
Domain: de-example.de
Authinfohash: 4213d924230224fd719218b4acbd92f96ebe4344f3d5d1478dede1aa44e4cf4b
Authinfoexpire: 20100724
Copy

response:CREATE-AUTHINFO1
status:connect
format:kv

Result: success
INFO: 53000080013 Domain "Status" is "connect"
INFO: 16350000040 Verification information must be provided for the holder(s) to avoid dedelegation by [2024-12-09T15:45:01+01:00]
INFO: 16350000041 Verification information must be provided for the holder(s) to avoid deletion by [2024-12-16T15:45:01+01:00]
Stid: 57ebbb10-9590-11df-a9e2-9519b5688882
Ctid: cba-9345345321
Copy

response:CREATE-AUTHINFO1
status:serverHold
format:kv

Result: success
INFO: 53000080015 Domain "Status" is "serverHold"
INFO: 16350000041 Verification information must be provided for the holder(s) to avoid deletion by [2024-12-16T15:45:01+01:00]
Stid: 57ebbb10-9590-11df-a9e2-9519b5688882
Ctid: cba-9345345321

 

Copy

request:CREATE-AUTHINFO1
format:xml

<?xml version="1.0" encoding="UTF-8"?>

<registry-request xmlns="http://registry.denic.de/global/5.0" xmlns:domain="http://registry.denic.de/domain/5.0"> 
  <domain:createAuthInfo1 hash="4213d924230224fd719218b4acbd92f96ebe4344f3d5d1478dede1aa44e4cf4b" expire="20100815">
    <domain:handle>de-example.de</domain:handle>
  </domain:createAuthInfo1>
  <ctid>987654321</ctid>
</registry-request>
Copy

response:CREATE-AUTHINFO1
status:connect
format:xml

<?xml version="1.0" encoding="UTF-8"?>

<registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
  <tr:transaction>
    <tr:stid>538f1687-963a-11df-a9e2-9519b5688882</tr:stid>
    <tr:ctid>cba-987654321</tr:ctid>
    <tr:result>success</tr:result>
    <tr:message level="info" code="53000080013">
      <tr:text>Domain "Status" is "connect"</tr:text>
    </tr:message>
    <tr:message level="info" code="16350000041">
      <tr:text>Verification information must be provided for the holder(s) to avoid deletion by</tr:text>
      <tr:argument>2024-12-16T15:45:01+01:00</tr:argument>
    </tr:message>
    <tr:message level="info" code="16350000040">
      <tr:text>Verification information must be provided for the holder(s) to avoid dedelegation by</tr:text>
      <tr:argument>2024-12-09T15:45:01+01:00</tr:argument>
    </tr:message>
  </tr:transaction>
</registry-response
Copy

response:CREATE-AUTHINFO1
status:serverHold
format:xml

<?xml version="1.0" encoding="UTF-8"?>

<registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
  <tr:transaction>
    <tr:stid>538f1687-963a-11df-a9e2-9519b5688882</tr:stid>
    <tr:ctid>cba-987654321</tr:ctid>
    <tr:result>success</tr:result>
    <tr:message level="info" code="53000080013">
      <tr:text>Domain "Status" is "serverHold"</tr:text>
    </tr:message>
    <tr:message level="info" code="16350000041">
      <tr:text>Verification information must be provided for the holder(s) to avoid deletion by</tr:text>
      <tr:argument>2024-12-16T15:45:01+01:00</tr:argument>
    </tr:message>
  </tr:transaction>
</registry-response